-- *******************************************************************
-- CISCO-LWAPP-CCX-RM-MIB.my:
-- Light Weight Access Point Wireless client CCX Radio Measurement
-- MIB
-- December 2005, Devesh Pujari, Bharat Biswal, Prasanna Viswakumar
--
-- Copyright (c) 2005, 2006 by Cisco Systems, Inc.
-- All rights reserved.
-- *******************************************************************CISCO-LWAPP-CCX-RM-MIB DEFINITIONS::=BEGIN
IMPORTSMODULE-IDENTITY,OBJECT-TYPE,Integer32FROM SNMPv2-SMI
MODULE-COMPLIANCE,OBJECT-GROUPFROM SNMPv2-CONF
MacAddress,TruthValue,TimeInterval,TimeStampFROM SNMPv2-TC
cLWlanConfigEntry
FROM CISCO-LWAPP-WLAN-MIB
cLApDot11IfEntry,cLApSysMacAddress,
cLApDot11IfSlotId
FROM CISCO-LWAPP-AP-MIB
ciscoMgmt
FROM CISCO-SMI;--**********************************************************************
--* MODULE IDENTITY
--**********************************************************************ciscoLwappCcxRmMIB MODULE-IDENTITYLAST-UPDATED"200604110000Z"ORGANIZATION"Cisco Systems Inc."CONTACT-INFO" Cisco Systems,
Customer Service
Postal: 170 West Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
Email: cs-aironet@cisco.com"
DESCRIPTION"This MIB is intended to be implemented on all those
devices operating as Central controllers, that
terminate the Light Weight Access Point Protocol
tunnel from Cisco Light-weight LWAPP Access Points.
Information provided by this MIB is for CCX related
features as specified in the CCX specifications.
The relationship between CC and the LWAPP APs
can be depicted as follows:
+......+ +......+ +......+ +......+
+ + + + + + + +
+ CC + + CC + + CC + + CC +
+ + + + + + + +
+......+ +......+ +......+ +......+
.. . . .
.. . . .
. . . . .
. . . . .
. . . . .
. . . . .
+......+ +......+ +......+ +......+ +......+
+ + + + + + + + + +
+ AP + + AP + + AP + + AP + + AP +
+ + + + + + + + + +
+......+ +......+ +......+ +......+ +......+
. . . .
. . . . .
. . . . .
. . . . .
. . . . .
+......+ +......+ +......+ +......+ +......+
+ + + + + + + + + +
+ MN + + MN + + MN + + MN + + MN +
+ + + + + + + + + +
+......+ +......+ +......+ +......+ +......+
The LWAPP tunnel exists between the controller and
the APs. The MNs communicate with the APs through
the protocol defined by the 802.11 standard.
LWAPP APs, upon bootup, discover and join one of the
controllers and the controller pushes the configuration,
that includes the WLAN parameters, to the LWAPP APs.
The APs then encapsulate all the 802.11 frames from
wireless clients inside LWAPP frames and forward
the LWAPP frames to the controller.
GLOSSARY
Access Point ( AP )
An entity that contains an 802.11 medium access
control ( MAC ) and physical layer ( PHY ) interface
and provides access to the distribution services via
the wireless medium for associated clients.
LWAPP APs encapsulate all the 802.11 frames in
LWAPP frames and sends them to the controller to which
it is logically connected.
Central Controller ( CC )
The central entity that terminates the LWAPP protocol
tunnel from the LWAPP APs. Throughout this MIB,
this entity also referred to as 'controller'.
Cisco Compatible eXtensions (CCX)
Wireless LAN Access Points (APs) manufactured by Cisco
Systems have features and capabilities beyond those in
related standards (e.g., IEEE 802.11 suite of
standards, Wi-Fi recommendations by WECA, 802.1X
security suite, etc). A number of features provide
higher performance. For example, Cisco AP transmits a
specific Information Element, which the clients adapt
to for enhanced performance. Similarly, a number of
features are implemented by means of proprietary
Information Elements, which Cisco clients use in
specific ways to carry out tasks above and beyond the
standard. Other examples of feature categories are
roaming and power saving.
Light Weight Access Point Protocol ( LWAPP )
This is a generic protocol that defines the
communication between the Access Points and the
Central Controller.
Mobile Node ( MN )
A roaming 802.11 wireless device in a wireless
network associated with an access point. The terms
'Mobile node' and 'client' are used interchangeably.
Radio Management (RM)
This term refers to managing the 802.11 radio
environment to provide the best quality service to
to the 802.11 wireless clients.
Service Set Identifier ( SSID )
SSID is a unique identifier that APs and clients
use to identify with each other. SSID is a simple
means of access control and is not for security.
The SSID can be any alphanumeric entry up to 32
characters.
REFERENCE
[1] Wireless LAN Medium Access Control ( MAC ) and
Physical Layer ( PHY ) Specifications
[2] Draft-obara-capwap-lwapp-00.txt, IETF Light
Weight Access Point Protocol "REVISION"200604110000Z"DESCRIPTION"Initial version of this MIB module. "::={ ciscoMgmt 520}ciscoLwappCcxRmMIBNotifs OBJECTIDENTIFIER::={ ciscoLwappCcxRmMIB 0}
ciscoLwappCcxRmMIBObjects OBJECTIDENTIFIER::={ ciscoLwappCcxRmMIB 1}ciscoLwappCcxRmMIBConform OBJECTIDENTIFIER::={ ciscoLwappCcxRmMIB 2}clcrDot11aConfigGlobal OBJECTIDENTIFIER::={ ciscoLwappCcxRmMIBObjects 1}clcrDot11bConfigGlobal OBJECTIDENTIFIER::={ ciscoLwappCcxRmMIBObjects 2}clcrApIfConfig OBJECTIDENTIFIER::={ ciscoLwappCcxRmMIBObjects 3}
clcrClientMeasurementReport OBJECTIDENTIFIER::={ ciscoLwappCcxRmMIBObjects 4}clcrWlanConfig OBJECTIDENTIFIER::={ ciscoLwappCcxRmMIBObjects 5}--**********************************************************************
-- Client Measurement request per 802.11a network
--**********************************************************************clcrdot11aBeaconEnabled OBJECT-TYPESYNTAXTruthValue
MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"When set to 'true', LWAPP APs broadcast radio
measurement request messages that include a
beacon measurement request information element
on 802.11a radio to clients compatible to
CCX versions 2 and above. This configuration
takes higher precedence than that on the radio
interface of the particular AP when
clcrAPIfOverrideGlobal is set to 'false'. "DEFVAL{ false }::={clcrDot11aConfigGlobal 1}clcrdot11aBeaconInterval OBJECT-TYPESYNTAXTimeInterval(6000..3240000)
UNITS"hundredths-seconds"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The interval in hundredths of a second, in
which the AP issues radio measurement request
message to client periodically for every SSID.
This configuration takes higher precedence than
that on the radio interface of the particular AP
when clcrAPIfOverrideGlobal is set to 'false'. "DEFVAL{6000}::={clcrDot11aConfigGlobal 2}--**********************************************************************
-- Client Measurement request per 802.11b network
--**********************************************************************clcrdot11bBeaconEnabled OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"When set to 'true', LWAPP APs broadcast radio
measurement request messages that include a
beacon measurement request information element,
on 802.11b/802.11g radio to clients compatible to
CCX versions 2 and above. This configuration
takes higher precedence than that on the radio
interface of the particular AP when
clcrAPIfOverrideGlobal is set to 'false'. "DEFVAL{ false }::={clcrDot11bConfigGlobal 1}clcrdot11bBeaconInterval OBJECT-TYPESYNTAXTimeInterval(6000..3240000)UNITS"hundredths-seconds"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The interval in hundredths of a second, at
which the AP issues radio measurement request
message to client periodically for every SSID.
This configuration takes higher precedence than
that on the radio interface of the particular AP
when clcrAPIfOverrideGlobal is set to 'false'. "DEFVAL{6000}::={clcrDot11bConfigGlobal 2}--**********************************************************************
-- Ccx configuration on Cisco AP Radio .
--**********************************************************************clcrAPIfTable OBJECT-TYPESYNTAXSEQUENCEOF ClcrAPIfEntry
MAX-ACCESSnot-accessibleSTATUScurrent
DESCRIPTION"This table represents the CCX related parameters on
the radio interface of the APs. The values configured
through the objects of this table are passed onto the
AP by the controller, when the AP joins the
controller.
There exists a row in this table for each conceptual row
in cLApDot11IfTable that represents a dot11 interface
of an AP. "::={ clcrApIfConfig 1}clcrAPIfEntry OBJECT-TYPESYNTAX ClcrAPIfEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Each entry represents a conceptual row in this table.
An entry corresponding to each dot11 interface of an
AP is added to this table when the AP joins the
controller and deleted when AP disassociates from the
controller. "AUGMENTS{ cLApDot11IfEntry }::={ clcrAPIfTable 1}
ClcrAPIfEntry ::=SEQUENCE{
clcrAPIfOverrideGlobal TruthValue,
clcrAPIfBeaconEnabled TruthValue,
clcrAPIfBeaconInterval TimeInterval}clcrAPIfOverrideGlobal OBJECT-TYPE
SYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"If this object is set to 'true', values populated
through clcrAPIfBeaconEnabled and
clcrAPIfBeaconInterval are considered for sending
beacon measurement requests.
If this object is set to 'false', the values
configured through the objects
clcrdot11bBeaconEnabled, clcrdot11aBeaconEnabled,
clcrdot11bBeaconInterval and clcrdot11aBeaconInterval
take precedence and are used for sending beacon
measurement requests. "DEFVAL{ false }::={ clcrAPIfEntry 1}
clcrAPIfBeaconEnabled OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"When set to 'true', LWAPP APs broadcast radio
measurement request messages that include a
beacon measurement request information element
to clients compatible with CCX versions 2 and
above.
Global configuration at network level takes
higher precedence if clcrAPIfOverrideGlobal is
set to 'false'. Radio measurement frames include
a beacon request information element for every
channel over which the measurement needs
to be performed. The measurement requests are
repeated at every interval configured through
clcrAPIfBeaconInterval. "DEFVAL{ false }::={ clcrAPIfEntry 2}clcrAPIfBeaconInterval OBJECT-TYPESYNTAXTimeInterval(6000..3240000)UNITS"hundredths-seconds"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The interval at which the AP sends radio measurement
request messages to the clients associated through
each and every SSID. "DEFVAL{6000}::={ clcrAPIfEntry 3}--**********************************************************************
-- * Beacon report from the CCX clients
--**********************************************************************clcrClientBeaconReportTable OBJECT-TYPESYNTAXSEQUENCEOF ClcrClientBeaconReportEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This table reports the received signal power as seen
by a wireless client when conducting radio
measurements. Clients measure the received signal
power by observing the beacon requests and probe
response messages on all the specified channels and
pass them to the APs through beacon reports.
An entry is added to the table by the agent when the
beacon report sent by the client arrives at the dot11
interface of an AP. An existing entry for a client
gets over-written when the subsequent reports arrive
at an AP from that client. The term 'client' here
refers to all the wireless CCX compliant devices like
mobile stations, tags etc.
An entry is deleted from this table when the particular
client dissociates from the AP. The entry also gets
deleted when the AP dissociates from the controller. "::={ clcrClientMeasurementReport 1}
clcrClientBeaconReportEntry OBJECT-TYPESYNTAX ClcrClientBeaconReportEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Each entry represents a conceptual row in this table
and populates the received signal power as observed
and reported by the respective client. "INDEX{ clcrClientMacAddress,
cLApSysMacAddress,
cLApDot11IfSlotId }::={ clcrClientBeaconReportTable 1}
ClcrClientBeaconReportEntry ::=SEQUENCE{
clcrClientMacAddress MacAddress,
clcrClientRxPowerSignal Integer32,
clcrClientTimeStamp TimeStamp}clcrClientMacAddress OBJECT-TYPESYNTAXMacAddressMAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This object identifies the MAC address of a
client that has sent a beacon report to the
AP. "::={ clcrClientBeaconReportEntry 1}
clcrClientRxPowerSignal OBJECT-TYPESYNTAXInteger32(-90..30)UNITS"dBm"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"This object represents the signal strength of the
beacon or probe response frame as seen by the
client. "::={ clcrClientBeaconReportEntry 2}clcrClientTimeStamp OBJECT-TYPESYNTAXTimeStamp
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"This object represents the value of sysUpTime at
which the beacon measurement report was
received. "::={ clcrClientBeaconReportEntry 3}--**********************************************************************
-- Table to represent CISCO CCX parameters
-- per each WLAN.
--**********************************************************************clcrWlanTable OBJECT-TYPESYNTAXSEQUENCEOF ClcrWlanEntry
MAX-ACCESSnot-accessible
STATUScurrentDESCRIPTION"This table represents the CCX parameters of a
particular WLAN.
There exist a row in this table corresponding to each
row representing a WLAN in cLWlanConfigTable. "::={ clcrWlanConfig 1}clcrWlanEntry OBJECT-TYPESYNTAX ClcrWlanEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Each entry represents a conceptual row in this table
and provides information about the CCX capabilities
of the WLAN. "AUGMENTS{ cLWlanConfigEntry }
::={ clcrWlanTable 1}
ClcrWlanEntry ::=SEQUENCE{
clcrVersionIESupport TruthValue,
clcrAironetIESupport TruthValue}clcrVersionIESupport OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"This object indicates the support for the Cisco
Compatible Extensions Version information element
on this WLAN.
A value of 'true' indicates the presence of the
support and 'false' indicates the absence of the
same. "::={ clcrWlanEntry 1}clcrAironetIESupport OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"This object indicates the support for the Cisco
Compatible Extensions Aironet information element
on this WLAN.
The support is enabled or disabled by setting
this object to 'true' or 'false' respectively. "DEFVAL{ false }
::={ clcrWlanEntry 2}--**********************************************************************
--* Compliance statements
--**********************************************************************ciscoLwappCcxRmMIBCompliances OBJECTIDENTIFIER::={ ciscoLwappCcxRmMIBConform 1}ciscoLwappCcxRmMIBGroups OBJECTIDENTIFIER::={ ciscoLwappCcxRmMIBConform 2}ciscoLwappCcxRmMIBCompliance MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for the SNMP entities that
implement the ciscoLwappCcxRmMIB module."MODULEMANDATORY-GROUPS{
ciscoLwappCcxRmDot11aConfigGroup,
ciscoLwappCcxRmDot11bConfigGroup,
ciscoLwappCcxRmApIfConfigGroup,
ciscoLwappCcxRmBeaconReportGroup,
ciscoLwappCcxRmD11WlanConfigGroup
}::={ ciscoLwappCcxRmMIBCompliances 1}--**********************************************************************
--* Units of conformance
--**********************************************************************ciscoLwappCcxRmDot11aConfigGroup OBJECT-GROUP
OBJECTS{
clcrdot11aBeaconEnabled,
clcrdot11aBeaconInterval
}STATUScurrentDESCRIPTION"This collection of objects represent the beacon
request and beacon interval parameters for 802.11a
networks. "::={ ciscoLwappCcxRmMIBGroups 1}ciscoLwappCcxRmDot11bConfigGroup OBJECT-GROUPOBJECTS{
clcrdot11bBeaconEnabled,
clcrdot11bBeaconInterval
}STATUScurrentDESCRIPTION"This collection of objects represent the beacon
request and beacon interval parameters for 802.11a
networks. "::={ ciscoLwappCcxRmMIBGroups 2}ciscoLwappCcxRmApIfConfigGroup OBJECT-GROUPOBJECTS{
clcrAPIfOverrideGlobal,
clcrAPIfBeaconEnabled,
clcrAPIfBeaconInterval
}STATUScurrentDESCRIPTION"This collection of objects represent the beacon
request and beacon interval parameters for the
respective 802.11 radio interfaces. "::={ ciscoLwappCcxRmMIBGroups 3}ciscoLwappCcxRmBeaconReportGroup OBJECT-GROUPOBJECTS{
clcrClientRxPowerSignal,
clcrClientTimeStamp
}STATUScurrentDESCRIPTION"This collection of objects represent information
about the beacon reports received from CCX
clients. "::={ ciscoLwappCcxRmMIBGroups 4}ciscoLwappCcxRmD11WlanConfigGroup OBJECT-GROUP
OBJECTS{
clcrVersionIESupport,
clcrAironetIESupport
}STATUScurrentDESCRIPTION"This collection of objects represent the CCX
settings on a particular WLAN. "::={ ciscoLwappCcxRmMIBGroups 5}END